.. _cmmIxLineStart:

cmmIxLineStart
================
----------------

SYNOPSIS
```````````

.. code-block:: none

   VT_I4 cmmIxLineStart(
    [in] VT_I4 MapIndex, [in] VT_PR8 DistList
    )


DESCRIPTION
`````````````

- 이 함수는 현재 위치로부터의 상대 좌표로의 직선 보간 이동을 수행합니다. cmmIxLine() 함수는 모션이 완료되기
  전까지 반환되지 않으며, cmmIxLineStart() 함수는 모션을 시작시킨 후에 바로 반환됩니다.

PARAMETER
`````````````

- MapIndex : 맵번호(Map index), 이 맵번호를 사용하기전에 먼저 cmnIxMapAxes() 함수를 통하여 해당 맵번호에
  유효한 축들이 맵핑되어 있어야 합니다.

\

- DistList : 현재 위치로부터의 상대적인 이동 좌표값(각 축의 이동 거리값)의 배열 주소. 이 배열의 크기는
  cmnIxMapAxes() 함수를 통하여 맵핑된 축의 수와 일치하여야 합니다. 거리의 단위는 “Unit distance”에 의해 정의되는
  논리적 거리를 적용합니다.

\

- IsBlocking : 완료될 때까지 기다리는 동안 윈도우 메시지를 블록(Blocking)할 것인지를 결정합니다. 

.. csv-table::
    :widths: 10 85
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    cmFALSE, 블록(Blocking)을 하지 않습니다. 따라서 해당 모션이 완료되는 동안에도 윈도우 이벤트를 처리합니다.
    cmTRUE, 블록(Blocking)을 합니다. 따라서 해당 모션이 완료되는 동안에는 윈도우 이벤트가 처리되지 않습니다.


RETURN VALUE
`````````````

+--------------+-----------+
| Value        | Meaning   |
+==============+===========+
| 음수         | 수행 실패 |
+--------------+-----------+
| cmERR_NONE   | 수행 성공 |
+--------------+-----------+


REFERENCE
```````````

- 논리적 거리 단위는 cmmCfgSetUnitDist() 함수에 의해 결정됩니다.

\

- cmmIxLineStart() 함수를 사용하는 경우에는 cmmIxIsDone() 함수나 cmmIxWaitDone() 함수를 사용하여 모션의
  완료를 확인할 수 있습니다.

\

- cmmIxLine() 함수를 사용하는 경우에는 INP 입력신호가 Enable 로 설정되었으면 Command 펄스 출력이
  완료되어도 INP 입력이 ON 이 되기 전까지는 모션이 완료되지 않은 것으로 간주되어 반환되지 않습니다. 
  스탭 드라이브는 INP 출력이 없는 경우가 일반적인데, 고객님의 부주의나 잘못된 설정으로 INP 입력에 대한
  설정이 Enable 로 되어 있을 경우 INP 입력이 스탭 드라이브를 통해 발생하지 않는 이유 때문에 모션 완료가 되지
  않는 경우가 발생할 수 있습니다.
  고객 여러분들께서는 스탭 드라이브 사용시에 이점을 주의해주시기를 부탁드립니다.


.. note:: 윈도우 이벤트라는 것은 무엇입니까?
    윈도우 운영체제는 Event Driven 혹은 Message Driven 방식3의 구조로 되어
    있습니다. 각 응용프로그램은 메시지 큐(Queue)를 가지고 있으며, 정확히 말하면, 
    메시지를 사용해 이벤트를 통지하는 방식으로 설계되어 있습니다. 윈도우
    메시지를 처리한다는 것은 메시지 큐에서 메시지를 하나씩 꺼내서 윈도우
    프로시저에 전송한다는 것을 의미하며, 이것은 그 행선지가 되는 윈도우에
    전송되어 처리됩니다.


EXAMPLE
```````````

- cmmIxLine 예제를 참고해주세요.




.. seealso:: :ref:`cmmIxLine`, :ref:`cmmIxLineTo`, :ref:`cmmIxLineToStart`